home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / picmanip / pic_r2z / topmap / topmap.doc < prev    next >
Encoding:
Text File  |  1995-05-05  |  3.8 KB  |  99 lines
  1. *****************************************************
  2. *           Fractal Topographical Maps              *
  3. *       Copyright (c) 1987 by Robert Adam II        *
  4. *              All rights reserved.                 *
  5. *****************************************************
  6.  
  7.  PURPOSE:
  8.     This program can be used to create a contoured surface 
  9.     with features resembling natural geological formations
  10.     (lakes, mountains, ...).  You may also display the results
  11.     in a limited number of ways.  
  12.          NOTE:  The display will only work correctly in low resolution
  13.                though you may generate a map in any resolution.
  14.  
  15.        
  16.  LANGUAGE:
  17.     This program was written entirely in Personal Pascal from OSS.
  18.  
  19.         
  20.  USE:
  21.     This is a GEM based program.
  22.  
  23.     FILE    load - load in a saved map file
  24.         new  - create a new map using the height and width from
  25.                       from OPTIONS menu
  26.          old  - load a map saved by version 0.1
  27.         save - save the current map to a file and, in the process,
  28.               name it
  29.         
  30.     VIEW    isometric   - a modified isometric view
  31.                 overhead    - a view from directly above which is the
  32.                              one you normally get when you create a new
  33.                  map
  34.                 perspective - a perspective view
  35.  
  36.     OPTIONS shadow - when drawing a map, produce shadows as though
  37.             the sun was to the left of the picture.  You will
  38.                         be given a choice of three angles (Low, Medium,
  39.                         High)
  40.         watch  - allows you to watch while a new map is being
  41.             produced.  ( You may want to hide the map from 
  42.                         yourself if you will be using it in a game that
  43.                         you will be playing. )
  44.         water  - if "water" is on you can not see below the surface
  45.             otherwise you see the underwater land contours
  46.         height - how many "tiles" high a new map will be
  47.         width  - how many "tiles" wide a new map will be
  48.         reset  - reset the colors to the TOPMAP setup (in case a
  49.             desk accessory changes back to the default colors)
  50.  
  51.  
  52.  MISCELLANEOUS:
  53.     You may cancel the display of a map by pressing the left mouse
  54.       button and holding it until the alert box appears then clicking on
  55.       the YES option.  You may not resume a canceled display, though you
  56.       may restart it.
  57.     
  58.     You cannot cancel the creation of a map started by NEW.  You must
  59.       either wait until it finishes or reboot.
  60.  
  61.     The SAVE and LOAD really do take a long time (~1 min. 30 sec. for
  62.       SAVE about half that for LOAD), it's not just your imagination.
  63.  
  64.     To map the colors to altitude, I divided the altitude range into
  65.       9 evenly sized pieces.  I assigned three of these pieces to the water
  66.       (blue) region, while each of the other colors got one piece.
  67.  
  68.  
  69.  
  70.  DATA FILE FORMAT:
  71.       The file is a Pascal file of integer (where an integer is a 16 bit word).
  72.  
  73.     word offset    value stored
  74.        ----------------------------------------------------------    
  75.     0        number of tiles in width
  76.     1        number of tiles in height
  77.     2-17        colors from xbios(7) call stored 0 to 15
  78.     ...        the data for the map stored in row order
  79.  
  80.     A "tile" is a square that is 65 pixels on a side.  The adjacent
  81.       tiles overlap by a column (or row), so in a 3 by 2 (width by height)
  82.       tile map, the pixel size is 193 by 129 instead of the expected
  83.       195 by 130.
  84.         The map data should be in the range of 0 to 25000 but it sometimes
  85.       strays out of bounds.
  86.     The map is stored a row at a time so the first 193 words of data for
  87.       a 3 tile wide map will be the first horizontal line of the map.
  88.  
  89.  
  90.  FINAL NOTES:
  91.     If you have any questions or comments you may reach me at one of
  92.       the following addresses:
  93.  
  94.         CompuServe: [74226,623]
  95.  
  96.                 U.S. Mail : Robert Adam II
  97.                             8029-B Trapier Ave.
  98.                 New Orleans, LA 70127
  99.